home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 February / EnigmA AMIGA RUN 04 (1996)(G.R. Edizioni)(IT)[!][issue 1996-02][Skylink CD III].iso / earcd / program / indexer.lha / indexer / indexer.doc < prev    next >
Text File  |  1995-11-05  |  3KB  |  66 lines
  1.                       Documentation for indexer v1.0.
  2.  
  3.  
  4. 1. Introduction.
  5. ===========================================================================
  6.  
  7. Why  did  I  wrote  indexer  ?  Why  not  :-).  Well, I write program (like
  8. dictionary)  which  manages  lot  of  files  (528  files - about 200 KB). I
  9. formatted  disk and copied these files on it (it took only (?!) about... 15
  10. minutes  (?!).  Next  I looked at DirOpus panel and saw that there was only
  11. about  288  KB free on the disk ! Why ? Yeah, each of files takes few bytes
  12. extra  space  (like FileInfoBlock). Don't worry - indexer can help you :-).
  13. The  main  purpose  of  this  tiny  program  is  to save the disk space and
  14. increase  efficiency  of disk access. Have you ever tried to copy 528 files
  15. from  HD to floppy ? Just press the "Copy" gadget and have a trip with your
  16. dog :-).
  17.  
  18.  
  19. 2. How does indexer work ?
  20. ===========================================================================
  21.  
  22. Don't  care...  Indexer  will join all files into one big file and generate
  23. description file. For example:
  24.  
  25.   indexer Work:many_files big_file index 100000
  26.  
  27. would  join  all  files which exist in directory "Work:many_files" into one
  28. big file "big_file" and generates description file "index". I/O Buffer size
  29. (here is 100000 bytes) is default 50 KB.
  30.  
  31.  
  32. 3. What is on the earth "description file" ?
  33. ===========================================================================
  34.  
  35. Description  file is text file and helps your routine (you should write one
  36. for  your  own) to read necessary file from "big file". There will be 3
  37. lines per file as presents below:
  38.  
  39. filename
  40. filesize
  41. offset
  42.  
  43.  
  44. 4. I have only AmigaOS1.3...
  45. ===========================================================================
  46. Wise  guy  !  Unfortunatelly,  indexer  doesn't  run  under  your Kick :-(.
  47. Although,  you  can  replace function FPrintf() which is v36+ and recompile
  48. code  (don't  forget  to  remove  line:  extern LONG __OSlibversion = 36;).
  49. Indexer  was  tested  on  my  A1200 with Kick 3.0 inside and I hope it runs
  50. under AmigaOS2.0, too.
  51.  
  52. 5. Cleanup.
  53. ===========================================================================
  54.  
  55. I  hate read and write "DISCLAIMERS" notes. There is source (SAS/C 6.50) of
  56. indexer in archive. Look at it if you want and ask yourself "Could be there
  57. any  bug  which  would format my hard drive ?". If you like indexer send me
  58. e-mail  and  tell  me  about  it. Sorry about grammar mistakes, but english
  59. isn't my native language.
  60.  
  61.              e-mail: lszelag@panamint.ict.pwr.wroc.pl
  62.                www: sun1000.ci.pwr.wroc.pl/amiga/amiuser/luk
  63.                IRC: #amiga, #amigapl, #usa (Luk)
  64.  
  65. See ya !
  66.